home *** CD-ROM | disk | FTP | other *** search
/ FishMarket 1.0 / FishMarket v1.0.iso / fishies / 376-400 / disk_390 / readmemaster / docs < prev    next >
Text File  |  1992-05-06  |  10KB  |  171 lines
  1. ***************************************************************************
  2. *                                ReadmeMaster                             *
  3. *                                Sept.13,1987                             *
  4. *                                Harold Morash                            *
  5. *                                 902-435-1895                            *
  6. *  IMPORTANT NOTE: This program is freely copyable and distributable.     *
  7. *  It is NOT Public Domain. All copyrights are reserved by the author.    *
  8. *  You may give copies of this program to anyone you wish but you may     *
  9. *  not sell it. I hope that you may find it useful if you collect or      *
  10. *  have access to the Fred Fish AMIGALIBDISK Library.                     *
  11. *                                                                         *
  12. *                                                                         *
  13. *  REVISION 1.1a Dated 16 September 1990                                  *
  14. *                                                                         *
  15. *       (1)  Fixed serious bug discovered only a week ago. My development *
  16. *            environment is on a A2500 68020 based machine. The only      *
  17. *            other tests that were made were conducted on a A2000         *
  18. *            68030 equipped machine. Seriously, there were no bugs        *
  19. *            found in these environments. BUT!, when an attempt was       *
  20. *            made by another individual to run it on his A1000 68000      *
  21. *            equipped machine it CRASHED. I had left the Lattice catch.o  *
  22. *            startup in the code which helped to find the problem.        *
  23. *            I deeply regret having released 1.1 with such a serious      *
  24. *            problem and can assure you the same mistakes will not be     *
  25. *            made again. -HTM-                                            *
  26. *                                                                         *
  27. *  REVISION 1.1  Dated 7 May 1990                                         *
  28. *                                                                         *
  29. *       (1)  Completely rebuilt all data files since the original program *
  30. *            would only allow 256 disks to be cataloged. Who ever thought *
  31. *            Fred's collection would ever grow this large. I didn't he    *
  32. *            was only at disk # 58 when this program first came to being. *
  33. *            Oh well, now it can grow to 65,535 disks and I guarantee if  *
  34. *            it does I wont be around to update it!!!                     *
  35. *                                                                         *
  36. *       (2)  The number of hits on each word are now 100% accurate. The   *
  37. *            original version had a maximum limitation on the number of   *
  38. *            hits a word could have. No limitations this time, but lets   *
  39. *            get realistic, at 325 disks there are words with over 800    *
  40. *            hits. This high a value has no real use unless you have a    *
  41. *            week to look at them. BUT!!!, UNIONS now is of even greater  *
  42. *            importance than it was before!!!! Each selection you make    *
  43. *            brings the number of UNIONS down, therefore reducing the     *
  44. *            amount of hits you will have to lookup.                      *
  45. *            EX: select the words -> utility, source, c                   *
  46. *                watch the Unions box...                                  *
  47. *                after the first 2 selections UNIONS = 67                 *
  48. *                after the 3rd selection UNIONS = 3                       *
  49. *                now activate HITS gadget                                 *
  50. *                you will see the first hit, activate NEXT gadget until   *
  51. *                the screen flashes. See you only had to lookup 3 hits    *
  52. *                where those 3 words each occured in the same filename.   *
  53. *                                                                         *
  54. *                By the way the total hits for those 3 words was 1041 !!! *
  55. *                                                                         *
  56. *       (3)  Hits greater than 99 will not be displayed. It really is of  *
  57. *            value to do so. This is because I wanted as much room as     *
  58. *            possible for displaying words. Any word with a number of     *
  59. *            hits greater than 99 will be displayed as two asterisks.'**' *
  60. *                                                                         *
  61. *       (4)  The AmigaLibDisk # string gadget is now visible.             *
  62. *                                                                         *
  63. ***************************************************************************
  64.  
  65. How to use this program:
  66.  
  67.    From CLI - cd to <device>:ReadmeMaster
  68.             - run ReadmeMaster
  69.  
  70.    From WorkBench - Double Click on Drawer Icon ReadmeMaster
  71.                   - Double Click on ReadmeMaster Icon
  72.  
  73.    Once the program starts it will only take it a few seconds to load its
  74. files and then you may begin.
  75.  
  76. Explanation of Gadgets:
  77.  
  78. Dictionary Side:-   
  79.  
  80.    Prop Gadget - is used to scroll through the Dictionary. It does so in
  81.                  very large chunks because you are actually moving through 
  82.                  about 156K of memory.
  83.    
  84.    Arrows      - are used to go up and down through the Dictionary one word
  85.                  at a time. They do repeat here.
  86.  
  87.    PageUp      - is used to move through the Dictionary 10 lines at a time.
  88.    PageDn      - same as above, only other direction.
  89.    
  90.    Select      - is for copying whatever is under the HighLiter over to the
  91.                  Selections window.
  92.    
  93. Selections Side:-
  94.  
  95.    Arrows      - are used to move the Highliter up and down through the
  96.                  selections. These do not repeat!
  97.                  
  98.    Hit         - is used to tell the program that you only want to lookup
  99.                  the Readme descriptions that are either Hits (one word
  100.                  selected) or UNIONS (sum of hits on all words selected).
  101.  
  102.    All         - is used to lookup all the hits on all the words selected.
  103.    
  104.    Next        - is used to lookup the next hit.
  105.    Prev        - is used to lookup the previous hit.
  106.    
  107.    UnSel       - is used to unselect whatever selection the Highliter is
  108.                  currently on.
  109.                  
  110.    Clear       - clears all selections.
  111.  
  112.    TW          - is a Tiny Window mode that has been implemented to allow
  113.                  the user to get back to either CLI or WorkBench to do
  114.                  something else if he so desires. To get back to ReadmeMaster
  115.                  just click the left mouse button in the tiny window. If
  116.                  anyone is using Tiny Window Manager which appeared in
  117.                  Transactor magazine a few months back this feature here is
  118.                  a client of this and therefore when in tiny window mode it
  119.                  would appear as a Gadget.
  120.  
  121.    There is one more Gadget that is not visible unless you know about it.
  122.    In the bottom view area you see 'AmigaLibDisk #'. To the right of '#' if
  123.    you click the left mouse button on it you will be able to type a number
  124.    which corresponds to the Fred Fish Disk number you would like to lookup.
  125.    This is a feature I decided to add because I felt it would come in handy
  126.    if you wanted to know what was on a particular disk.
  127.    
  128.    One more feature I added was the ability to select words by pointing to
  129.    the one you want and pressing the left mouse button. This one was to
  130.    satisfy Ron Whitaker who likes to select with his mouse!!
  131.  
  132.    I would like to especially thank Ron for his support and guidance       
  133.    throughout this project, Ernie Poirier for his work on the icon for the 
  134.    program, and Transactor Magazine for their Tiny Window Manager 
  135.    program.
  136.  
  137. >>>May/90 I would also like to thank all those who supported the first
  138.           version of ReadmeMaster, whom without their interest this version
  139.           may not have come to reality. Thank you -Harold-
  140.  
  141.    If anyone has any comments, suggestions, or problems I would greatly
  142.    appreciate a call as long as it is during a reasonable hour, or a letter.
  143.    Please take the time with problems to document exactly how you got it,
  144.    as this is the best way to track them down and find a possible solution.
  145.  
  146.    I will provide updates to the files the program uses as more of the Fred
  147.    Fish Disks become available to me. There is a file included in this
  148.    directory which tells what disks are currently in the Dictionary.   
  149.    If you would like an update to the files please send enough money to 
  150.    cover return postage and the cost of a disk to:
  151.            
  152.            Harold Morash
  153.            77 John Stuart Drive
  154.            Dartmouth, Nova Scotia
  155.            Canada
  156.            B2W 4J7
  157.  
  158. >>>NOTE:- Dated May 1990. Don't send blank disks!!! I received several that
  159.           were not even any good for bookends. This hopefully was not
  160.           intentional, but from now on I will only accept $$$$. Let's say
  161.           $10 or more whatever you decide.
  162.  
  163.    If you want to move this program to another disk please ensure that all
  164.    the files in the ReadmeMaster Directory get moved to the same place 
  165.    (root or sub-directory) or else the program wont work.
  166.  
  167.    I do hope you find this program useful because that will make
  168.    the entire time I spent on this project very worthwhile.
  169.    
  170.    -Harold Morash
  171.